.TH E1432_SET_SOURCE_OUTPUT 3 E1432
.SH NAME
.nf
e1432_set_source_output \- Set source output type
e1432_get_source_output \- Get current state of source output
.fi
.IX e1432_set_source_output(3) 3
.IX e1432_get_source_output(3) 3
.SH SYNOPSIS
.cS
SHORTSIZ16 e1432_set_source_output(E1432ID hw, SHORTSIZ16 ID,
                                   SHORTSIZ16 output)
SHORTSIZ16 e1432_get_source_output(E1432ID hw, SHORTSIZ16 ID,
                                   SHORTSIZ16 *output)
.cE
.SH DESCRIPTION
\fIe1432_set_source_output\fR sets the source output, of a single channel
or group of channels \fIID\fR, to the value given in \fIoutput\fR.

\fIe1432_get_source_output\fR returns the current value of the source
output, of a single channel or group of channels \fIID\fR, into a memory
location pointed to by \fIoutput\fR.

\fIhw\fR must be the result of a successful call to
\fIe1432_assign_channel_numbers\fR, and specifies the group of
hardware to talk to.

\fIID\fR is either the ID of a group of channels that was obtained with a
call to \fIe1432_create_channel_group\fR, or the ID of a single channel.

\fIoutput\fR determines the source output.  The valid values are:

\fBE1432_SOURCE_OUTPUT_NORMAL\fR for normal source output, as defined
by the source mode and other source parameters.

\fBE1432_SOURCE_OUTPUT_GROUNDED\fR to have the source output connector
remain grounded, while internally connecting the source DAC to the
CALOUT line in the module.  Because the signal does not pass through
the range attenuator or analog filter circuits, the signal amplitude
is controlled only by \fBe1432_set_amp_scale\fR.  Starting the source
will leave the source output connector grounded, and drive the source
signal (as defined by the source mode) onto the CALOUT line.

\fBE1432_SOURCE_OUTPUT_OPEN\fR to have the source remain open
circuited even when the source is started.  The impedance on the
output is actually only about 1K ohm, because the power-fail decay
circuit is still connected to the output.

\fBE1432_SOURCE_OUTPUT_CAL\fR to connect the source output connector
to the module's internal CALOUT line.  This allows the module's CALOUT
line to be driven by an external signal applied at the source output
connector.

\fBE1432_SOURCE_OUTPUT_MULTI\fR to connect the source output connector
to the module's internal CALOUT line, and also connect the source DAC
to the CALOUT line.  This is a combination of the GROUNDED and CAL
values above, and is useful for multi-mainframe calibration.

Obviously, this function is not useful when talking to input or tach
channels.  Only source channels have a source output.
.SH "RESET VALUE"
After a reset, \fIoutput\fR is set to
\fBE1432_SOURCE_OUTPUT_NORMAL\fR.
.SH "RETURN VALUE"
Return 0 if successful, a (negative) error number otherwise.
.SH "SEE ALSO"
.na
e1432_set_source_mode, e1432_set_calin, e1432_set_active,
e1432_set_amp_scale
.ad
